home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1999 July / Software of the Month - Ultimate Collection Shareware 263.iso / pc / Xtras / Widget Wizard / Widget Wizard Read Me < prev    next >
Text File  |  1997-05-10  |  12KB  |  215 lines
  1. Widget Wizard: Read Me                                                                         
  2. April 1997
  3.  
  4. -What is the Widget Wizard?
  5. -How to use this tool
  6. -Getting started
  7. -What are behaviors?
  8. -What to look out for
  9. -How to make your movies cleaner
  10. -Who made the Widget Wizard?
  11.  
  12. ----------------------------------------------------------------------------
  13. What is the Widget Wizard?
  14.  
  15. The Widget Wizard is a browser of frequently used buttons and devices. 
  16.  
  17. While authoring your own movie, choose the Widget Wizard from the Xtras menu to browse the
  18. widgets and then paste any of them into your movie. You can also open the Widget Wizard in
  19. authoring mode. Widgets cannot be inserted directly into another movie when opened in
  20. authoring mode, but you can select and copy any of the elements such as cast art,
  21. behaviors, or score elements.
  22.  
  23. You can also copy buttons from the Button Library.
  24.  
  25. How to use this tool
  26.  
  27. Use the Widget Wizard to quickly add functionality to your movie, or use it as a way to see
  28. how the different widgets are built using screen elements and Macromedia's packaged
  29. behaviors. You can also add your own behaviors to the Widget Wizard.
  30.  
  31. When selected from the Xtras menu, the Widget Wizard plays as a movie in a window (MIAW),
  32. and displays using the default palette of the stage. Therefore, if you open the Mac Widget
  33. Wizard while authoring a movie using the Windows palette, you will see a palette whack if
  34. your monitor is set to 8 bits. If your monitor is set to a higher bit depth, you will
  35. insert cast members with a different palette than the default palette of your movie. In
  36. that case reinsert the widget (you can try remapping the pixels to the proper palette as
  37. well)
  38.  
  39. Use the Widget Wizard as a starting point. Exchange art customized to your interface.
  40. Examine the behaviors and enhance them for your needs.  If you make changes to scripts or
  41. art, be sure to open the parameters to be sure that they are properly customized. 
  42.   
  43. Getting started
  44.  
  45. 1. Open a new or an existing movie. 
  46.  
  47. 2. Select the Widget Wizard for the desired platform (default palette) from the Xtras menu. 
  48.  
  49. 3. Browse through the wizard until you see a widget you'd like to insert in your movie. The
  50. text field in the wizard will tell you how many channels the widget uses.
  51.  
  52. 4. Click a frame in the score of your movie that has at least 5 open frames following and
  53. enough channels below to accommodate it. If you have not clicked in a usable frame, a
  54. message will tell you to do so. 
  55.  
  56. 5. Click the Insert Button, and wait for the beeps. The instruction window will pop open if
  57. it is not already open. If you accidentally close it, click the ? button.
  58.  
  59. 6. Follow the instructions in the window to finish customizing the behaviors used in the
  60. widget. 
  61.  
  62. Many widgets will play without any customization. However, if you change the score
  63. location, score layout, cast member location, or cast member name of any part of the
  64. widget, you need to re-customize the parameters for the behaviors used in that widget.
  65.  
  66. What are behaviors?
  67.  
  68. The widgets in this wizard take advantage of Director's packaged behaviors. Many of them
  69. were adapted from the Behavior Library located in the Xtras folder. 
  70.  
  71. A behavior is a encapsulated piece of code. A behavior can control either a sprite or a
  72. frame. In this wizard's widgets, the only frame behavior that gets used is called "loop
  73. current frame"; it is a simple "go to the frame" script. 
  74.  
  75. The rest of the behaviors control the sprites they are attached to.  Many behaviors perform
  76. tasks that take into account details that are unique to the sprite being activated at that
  77. instant. These details are called "parameters."
  78.  
  79. Many sprites can use a single behavior, and yet perform differently. Just as each child in
  80. a classroom will answer the question: "What is your name?" differently depending on the
  81. parameter that is her or his name, different sprites may display different castmembers on
  82. mouseDown when clicked. That is because they each have different "down state" parameters
  83. stored.
  84.  
  85. Access parameter information by opening the Behavior Inspector and then selecting a sprite.
  86. You will see a line in the top pane of the window that decribes the behavior's parameters.
  87. The Beep widget sprite displays this line:  
  88. 33:beep-2pict (WidgetBehaviors)DownCM: "SoundButton.Down", whichevent:mouseUp
  89.  
  90. The changeable parameter for this behavior is the mouseDown pict: "SoundButton.Down", and
  91. it is displayed in quotes.
  92.  
  93. The individual behavior cast is not altered by customizing the parameters for a sprite.
  94. Conversely, you must enter the parameters for every sprite using the behavior in your
  95. movie. To better understand this, open the widget wizard in authoring mode, open the
  96. Behavior Inspector and look at a widget that uses the same behavior for several sprites:
  97. the Menu widget. Click each sprite to see the editable parameters: 
  98. the down pict (DownCM) and the marker to jump to (whichLabel). If you open the script by
  99. clicking the script icon, you will notice that only the parameter names, not the entered
  100. details (or descriptions) are in the script.
  101.  
  102. Another way of adding behaviors to sprites in your movie is to drag a behavior from the
  103. cast directly onto the sprite in the score, or the stage. When you do this, a dialog box 
  104. usually opens, prompting you to customize the parameter information for the particular
  105. sprite that you have dragged the bevavior to.  You can also attach multiple behaviors to
  106. the same sprite. Drag behaviors to the sprite in the order you want them executed (or
  107. reorder them in the Behavior Inspector.)
  108.  
  109. To make the Widget Wizard as simple as possible to use, we have combined multiple behaviors
  110. into a single script, and customized the defaults to enter the most likely parameter
  111. details into the behavior before it is even opened. 
  112.  
  113. What to look out for.
  114.  
  115. The Widget Wizard pastes widgets into your movie in sprites of15 frames (or as few as 5
  116. frames if less open space is available.) This allows you to take advantage of the new score
  117. display features in Director 6. 
  118.  
  119. If you move a widget, or change the dimensions of the stage, you may need to update the
  120. parameters. Always check the parameters whenever you move sprites with behaviors.Widget
  121. cast members are pasted every time the widget is inserted. The Widget Wizard only checks
  122. for duplicates within the widget. If you have inserted this or a similar widget before,
  123. scripts will be duplicated. See section: How to make your movies cleaner, below.
  124.  
  125. The behaviors calculate default parameters based on information it gathers as the behavior
  126. is attached (either when the widget is inserted, or when it is manually attached). In this
  127. way many behaviors will work without customizing the parameters. These are typically
  128. calculated default parameters:
  129.  
  130. mouseDown Pict: the name of the cast memeber that is in the cast location following the
  131. sprite's castMember. If there is another cast member with the same name, then the first
  132. castMember found will be displayed on mousedown.
  133.  
  134. Sprite numbers: when multiple sprites work together, (in widgets like the QT controller and
  135. the text scroller) the behavior looks at a sprite number to control. The default is
  136. calculated on the difference between the sprite number where the behavior is located, and
  137. the sprite number to be controlled. If you change these relationships after inserting, you
  138. will need to update the behaviors parameters. Check the parameters any time you move a
  139. widget in the score.
  140.  
  141. Performance of pasted widgets is generally slower in your movie when the widget wizard is
  142. open. Close the Widget Wizard and save your movie to improve performance. 
  143.  
  144. The Image Mover Widget displays a "jump" when the drag bar is clicked on if a MIAW is
  145. opened. This does not seem to happen in projectors however. Use with caution.
  146.  
  147. QT movies persist on the stage when played Direct to stage (which offers the best
  148. performance.) This means that the QT movie will stay visible on the stage untill it is
  149. covered by something else. Overcome this by placing a bitmapped image in the same location
  150. on the stage for one frame at the beginning of all sections that can be accessed from the
  151. frame with the QT movie. The cast member "QT mask" is provided with the widget for this
  152. purpose.
  153.  
  154. Widget cast members will be pasted into your movie at the same bitdepth as your monitor.
  155. For best results, set your monitor to 8 bit (256 colors) to avoid having to transform the
  156. bit depth later. If you do find 16-bit or 32-bit cast members, transform them with the
  157. Remap Colors option checked. If you must transform widget art, generally select Remap
  158. Colors rather than Dither since all art in the Widget Wizard is already 8 bits in depth.
  159.  
  160. You will get a script error if a widget attempts to display a cast member that is not
  161. available in the cast. Be sure that cast members are not needed before deleting them.
  162. Always save your movie as a new version when you delete any cast members. Then retest.
  163.  
  164. You will get odd behavior if you do not complete parameter custonization for many widgets.
  165. The first paragraph of the instructions will identify the parameters that need
  166. customization, and other work that is needed to make the widget work properly. 
  167.  
  168. The buttons in the Buttons tab have only mouseDown behavior, and will work immediately.
  169. Complete their functionality by dragging additional behaviors to them. In this way you are
  170. stacking behaviors. Because most behaviors in the Widget Wizard have multiple behaviors
  171. within them, they are not suitable for combining with other behaviors. Use the behaviors
  172. found in the Behavior Library located in the Xtras menu. Copy the behavior into your cast
  173. for best portability.
  174.  
  175. How to make your movies cleaner.
  176.  
  177. If you paste many widgets into your movie, you will notice that some scripts are
  178. duplicated. Generally, it is desirable to use the same script many times, rather than to
  179. duplicate the script for each use. 
  180.  
  181. Because scripts can be changed without being renamed, we decided to err on the side of
  182. safety, and give you every element needed for each paste. To clean out redundant "loop
  183. current frame" frame scripts, select one script to remain (non redundant), and exchange the
  184. others for the desired one. To do this:
  185.  
  186. 1. Select the frame script to be exchanged in the script channel of the score.
  187.  
  188. 2. Select the desired non-redundant "loop current frame" 
  189.  
  190. 3. Select Exchange Cast Memebers from the Edit menu.
  191.  
  192. 4. When you are done, delete the frame script that is no longer used. 
  193.  
  194. 5. Search the score to make sure it is not being called anywhere:
  195. -Select the redundant frame script in the score.
  196. -Choose Find Selection from the Edit menu.
  197. -Use caution. Only frame scripts can be searched for in the score. 
  198. -If the frame script is not found, (Director will beep), delete the script. 
  199. -Then, select Save As... from the File menu to save a new version of your movie. 
  200.  
  201.  
  202.  
  203. Who made the Widget Wizard?
  204. The Widget Wizard was commissioned by Diana Wynne at Macromedia to help people make better
  205. use of the behaviors they developed. 
  206.  
  207. Design, writing, and production by Lisa Coen (lisacoen@sighton.com)
  208. Programming for the tool by Frances Killam (Frances@DigMuse.com)
  209. All behavior scripting by Andy Rose at Macromedia.
  210.  
  211. Additional technical consultation was provided by Kevin Mullet, David Calaprice, Tracy
  212. Stampfli, Buzz Kettles, and Mike Seery at Macromedia, and by Tom Ransdell at Digital Muse.
  213.  
  214. Please send comments and ideas to us: widgets@sighton.co
  215.